PsL Monthly 1993 December

home *** CD-ROM | disk | FTP | other *** search

/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / coref.exe / CREF.DOC < prev next >

Wrap

Text File | 1992-08-10 | 19.3 KB | 454 lines

CREF Charts of Reference Version 1.1 ────────────────────── Command Line & TSR Versions ──────────────────────────── (C)Copyright 1992 Rand Nowell RaLin Enterprises "Putting Bits Together" (tm) - Program Documentation - MANUAL INDEX LEGAL STUFF..........................................0 SHAREWARE ?..........................................1 SYSTEM REQUIREMENTS..................................1 WHERE TO PUT CREF....................................1 STARTUP: Save Screen......................................1 No Save Screen...................................1 TSR VERSION..........................................4 SELECTING MENU ITEMS.................................2 HOT KEY SWITCHING....................................2 THE CHARTS: The Information. <K> Keys..Extended Keys..........................2 <T> Attr..Text Attributes........................2 <C> Char..Character Codes......................2,3 <A> Pascal..Color Codes..........................3 <N> Ansi..Ansi Escape Codes......................3 <S> Ascii..Ascii Text Color Codes................3 <Q> Quit..Exiting CREF...........................3 MACROS: Calling from programs. Qedit............................................3 Boxer..........................................3,4 Qmodem...........................................4 Other Programs...................................4 REGISTRATION.......................................4,5 SUGGESTIONS..........................................5 ACKNOWLEDGEMENTS.....................................5 DEVELOPMENT..........................................5 SUPPORT..............................................5 Copyright: CREF 1.1 is not a Public Domain or Free program. It is the Copyrighted (c) 1992 work of Rand Nowell dba Ralin Enterprises. All rights are reserved. Copying, duplicating, selling or otherwise distributing this product except as noted in the Distribution Policy below is a violation of Federal Copyright Law. You are authorized to evaluate the program for a period of 30 days. If after 30 days you wish to continue using the program, a registration is in Order. Please see REGCOM.DOC Distribution: 1. Feel free to distribute the Shareware version of this program as often as you like to any interested parties. Distribution to Electronic Bullentin Boards is encouraged. 2. Please do not distribute this program without all the original related files such as documentation, readme files, registration forms etc. 3. Please distribute ONLY the original authenticated ZIP format file. 4. Please obtain our written permission before including the program with any "bundled" software packages. 5. Please do not accept payment for the program; a copying fee of $5.00 per diskette may be charged by a non-profit user-group. 6. Please do not alter the program or documentation in any way. 7. Individuals, groups, vendors or other software distribution companies which market diskettes containg shareware or test-drive evaluation programs, for profit, must obtain written permission from RaLin Enterprises prior to distribution. DISTRIBUTION of the REGISTERED version of this program is in violation of the license agreement and copyright law. ************************* DISCLAIMER ***************************** This program is supplied "as is" without warrenty of any kind. The entire risk of using, and results from the use of, is assumed by you the user. You assume all costs of repair, servicing and corrections stemming from the use of this program. Rand Nowell and/or RaLin Enterprises, or any other associated company of the program author will not be held liable for any damages from the use of this program. No warrenties are expressed or implied. ******************************************************************** To the original licensee of the REGISTERD version of CREF 1.0 RaLin Enterprises DOES warrant that the program disk(s) on which the program is recorded, be free from defects in material and workmanship under normal use and service for a period of (90) ninety days from date of delivery as evidenced by your receipt. Our entire liability and your exclusive remedy shall be replacement of the deffective disk not meeting the standards of this limited warranty. CREF.DOC Charts Of Reference Manual Page 1 SHAREWARE? What is it ? A shareware program is one that the author distributes for the people to try, free of charge. Usually the author will set a time limit on this "Free Trial" and if you continue to use the product after this time period, you are usually expected to pay a small registration fee. Unlike commercial software where you Buy then Try, this allows you to evaluate the program without investing your hard earned money, then if you like it and find it useful and only then, do you register it. If you do not intend to register a shareware program, you should stop using it, and delete it from your system. What a deal! SYSTEM REQUIREMENTS: Memory: Runs in minimum amount of memory. If calling from within another program then figure on CREF using about another 52k of memory. Video: Requires a graphics card and color monitor. Dos Version: Will work from 3.0 up, not tested in lower versions but should work with 2.0 + There is no version checking within the program. WHERE TO PUT IT: CREF should be stored in a directory that is included in your path statement. This is especially true if you are going to be calling it from within another program. Placing CREF in a "PATH" directory will allow it to be called from anywhere in your system. STARTUP: Command syntax: CREF [/s] CREF alone will call the program without saving the underlying screen, the screen is cleared on starting and on completion. [/s] If you wish to preserve your underlying screen, so that you can view it while using CREF, use the switch /s the 's' MUST be lower case, and the switch must have a space between it and CREF. The /s switch has no effect when CREF is called from within another program, as that program performs a Dos SHELL to run CREF, and should save its own screen. (See the MACROS section.) Once CREF has started you will see a Title and Copyright notice at the top of the screen, and just below it to the far left will be the CREF menu. Information at your fingertips! CREF.DOC Charts Of Reference Manual Page 2 Artery....The study of fine paintings. SELECTING MENU ITEMS: There are several ways to select items on the Menu. 1. Use the up/down arrow keys to highlight your choice, then press <Enter>. 2. Press the highlighted letter of a Menu item. 3. Using the arrow keys, move the highlight bar to a selection, then press the right or left arrow key. HOT KEY SWITCHING: Once you have a chart on the screen, you may put it away by pressing ESC. This returns you to the Menu to make another choice or to Exit. But it is not necessary to return to the Menu to view another chart, when any chart (except the Character charts) is active, you can press the HotKey of any Menu choice and replace the current chart with the one called. The exception to this HotKey trick is the Character Charts...there are three of them, pressing any key other than escape will rotate between them, pressing Esc exits back to the Menu. So you must return to the Menu to select another chart when viewing the Character Charts. Example: Suppose you are viewing the P(a)scal chart, pressing the letter (n) would immediately display the A(n)si chart. * Its a neat trick! * Nitrate......different than the day rate. THE CHARTS: <K> Keys: The Keys chart is a full screen display of Extended Key codes, these are the codes generated when an Alt/Ctrl/Shft key combination is pressed, also the 12 Function keys F1 - F12. When these combination keys are pressed there are actually two codes produced, the first is always 0 (thats zero) and the second is the decimal code listed in this chart. Codes can also be referenced in Hexadecimal, but this chart shows only the decimal codes. There is also a short example of how to determine if an Extended key code has been generated. This example is in Pascal format. Press Esc to put this chart away and return to the Menu, or HotKey to another. <T> Attr: The Attribute Chart shows the Background/Foreground decimal codes. The first digit is the Background color, the second is the foreground. These numbers are shown using Decimal and Hex format for those situations where you need to use this format. <C> Char: This produces a group of 3 screens showing the character codes. Some of these would be entered with the Ctrl key, others would Information at your fingertips! CREF.DOC Charts Of Reference Manual Page 3 be entered using the Alt key and the number pad keys. If you were to hold down the Alt key and, using the keys on the number key pad, type 251, it would produce the checkmark (√) such as this. Remember, when using the Alt+Number method, the numbers must be entered using the key pad to the right of the keyboard. It will not work using the number keys at the top of the keyboard. Pressing the spacebar will cycle through these 3 screens, pressing Esc will exit to the Menu. You cannot HotKey to another chart from the Character charts. Tumor.....An extra pair. <A> Pascal: This displays a chart of color numbers that can be used when you need to specify both colors with one number. Using a Pascal example again, TextAttr:=95 would produce bright white on magenta. <N> Ansi: This chart displays many of the Ansi color codes that are useful in assigning color to text in Dos batch files. The proper syntax is also shown for such commands. <S> Ascii: Here we have the Dos textcolor codes. This chart is somewhat similar to the Attr chart above, but the color numbers are all in decimal. A Pascal example would be TextBackground(5);TextColor(15) would give us bright white on magenta. <Q> Quit: Last but not least is the Quit option. Exits CREF and returns you to the calling program, or Dos. If the /s switch was used, your screen will be restored to its startup state. Hangnail.....A coathook. MACROS: Here a couple of macros for calling CREF from some popular programs. 1. Qedit: Using Qconfig.exe and the qconfig.dat assign this macro to the available key of your choice.... MacroBegin SaveFile Dos 'CREF' Return Quit EditFile CurrentFileName Return This macro will save the file you are working on, shell to dos and run CREF, then return to Qedit, reload you file, and put you right back where you left off. This is the macro I use, and have used it several times during the writing of this Manual. 2. Boxer: You must assign the commands to a macro key, here we are assigning it to Ctrl-C, here are the steps. a) Press F8 b) Press F9 (Boxers Dos Call key) c) Type CREF d) Press Enter e) Once the CREF menu is displayed press (Q)uit f) Press any key to return to Boxer g) Press F8 again Information at your fingertips! CREF.DOC Charts Of Reference Manual Page 4 h) Enter a title for the macro, such as Calls Cref Charts. * Thats it...your ready to call CREF from the Boxer Editor any time you need it. 3. Qmodem: You probably wouldn't need CREF to often here, but if you are writing a script and want to use colors, access the CREF Pascal chart for the proper color numbers. Remember to add 128 to the color number if you want the foreground color to blink. NOTE: If you want to be able to call CREF when writing Qmodem scripts, you will have to use another editor. Qmodem's editor QMEdit won't allow macros, or a Dos shell. Configure the program to call another editor such as Qedit. Urine.....opposite of "Your Out" But you can call CREF from the terminal screen, press Alt-J to call up the macro editor, choose a key combination to use, then enter @shellx CREF and save. Then pressing that key combination will shell out and load CREF. This is assuming that CREF can be found by the system. (Refer back to Where To Put CREF.) As for setting up CREF to be called from any other programs, these examples should give you an idea on how to set it up. Refer to the particular programs documentation on how to set up external program calls. *********************************************************************** TSR VERSION: The TSR version has been created! Please refer to the CREFR.DOC for any differences in the program. ************************************************************************ REGISTRATION: If you find CREF useful to you, and you continue to use it, then you should REGISTER it. This will show me that the program is being well received and induce me to continue its development, such as more charts etc. Node.....Was aware of. If there appears to be no intrest in the program, ie lack of Registrations, then I will not further its development. Seems fair...eh what!? If you send me $10.00 (or more <grin>) I will send you new copies of the programs on disk, you will also receive some more handy utilities from RaLin Enterprises...for FREE. A registration form has been provided for anyone that wishes Information at your fingertips! CREF.DOC Charts Of Reference Manual Page 5 to donate to the cause. <REGCOM.DOC> You will be recorded in our database as a registered user. You will receive notices of new product releases. You will receive unlimited support for the product..... and anything else I can think of to treat you right! SUGGESTIONS: If you have some suggestions, or requests, pertaining to types of charts to add to CREF, please use the Suggestion/Comments form that is provided. <REGCOM.DOC> I do hope that CREF helps you in your work! ACKNOWLEDGEMENTS: Several products have been mentioned here, now we will pay respect to the authors..... Pascal: By Borland International...a fantastic programming language. Qedit: By SemWare...one of the BEST editors around. Boxer: By David R. Hamel....an awesome text editor...kudos to Dave! Qmodem: By Mustang Software...the premier Communications package. CREF: By Rand Nowell/RaLin Enterprises....wait a minute here..... DEVELOPMENT: CREF was written in Turbo Pascal. Borland International. Screens and menus generated by Saywhat! Screen Developer from Software Science, a fantastic screen developer for multiple programming languages and Dos batch files! Medical Staff......doctors cane. SUPPORT: I can be reached at the following: Phone: 510-651-0253 If I'm out leave a message. I return registered users calls at my expense, otherwise it will be collect. NetMail: 1:/215/777 or 1:161/42 - Rand Nowell CIS: 76124,761 Mail: 40728 Sundale Dr. Fremont, Ca. 94538 FIDO: Shareware Echo - Rand Nowell Genie: R.Nowell Information at your fingertips! ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 4,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394